home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / relnotes / impactvideo / ch4.z / ch4
Encoding:
Text File  |  2002-10-08  |  9.1 KB  |  331 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        4.  _D_o_c_u_m_e_n_t_a_t_i_o_n__A_d_d_i_t_i_o_n_s__a_n_d__E_r_r_o_r_s
  9.  
  10.        4.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s__t_o__C_o_n_t_r_o_l_s
  11.  
  12.        The following sections list, by node, the changes or
  13.        additions made to the control set.
  14.  
  15.        _D_e_v_i_c_e _N_o_d_e
  16.  
  17.           +o VL_MGV_INPUT_ALPHA_LUT_SELECT,
  18.             VL_MGV_OUTPUT_ALPHA_LUT_SELECT. These controls have
  19.             been moved to the Blender node.
  20.  
  21.           +o VL_MGV_DMA_READ_BURST_LEN, VL_MGV_DMA_WRITE_BURST_LEN
  22.  
  23.             These API device controls are used to set the
  24.             SpeedRacer professional video VGI1 DMA controller's
  25.             read/write burst lengths. The reason why this API was
  26.             created was to avoid the video hardware resetting due
  27.             to DMA lockup. This control should only be used if the
  28.             video hardware is presenting this problem.
  29.  
  30.  
  31.             These controls are hardware specific and will only work
  32.             on the SpeedRacer. The burst length is the maximum
  33.             length of DMA burst on GIO64 bus.  On each clock cycle
  34.             8 bytes are transferred. So this value will effectively
  35.             tweak the HOST to Video (read) or Video to Host (write)
  36.             DMA transfer length.
  37.  
  38.             As part of the library used for the video server daemon
  39.             two environment veriables SRV_VGI1_READ_BURSTLEN &
  40.             SRV_VGI1_WRITE_BURSTLEN override the API values for
  41.             this setting:
  42.  
  43.             e.g. in csh
  44.  
  45.                  setenv SRV_VGI1_READ_BURSTLEN  64
  46.                  setenv SRV_VGI1_WRITE_BURSTLEN 64
  47.  
  48.             When data starts transferring, the video server daemon
  49.             will always defer and use these environmental variables
  50.             for the burst length.  This method takes precedence
  51.             over the API device controls.
  52.  
  53.             Maximum length of DMA burst on GIO64 (bus)
  54.  
  55.                  from 1   = one double word  (1   clock cycle)
  56.                  to   255 = 255 double words (255 clock cycles)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.             The default values are 128.
  75.  
  76.  
  77.             Control                        Default       Type
  78.             VL_MGV_DMA_WRITE_BURST_LEN     Persistent    intVal
  79.             VL_MGV_DMA_READ_BURST_LEN      Persistent    intVal
  80.  
  81.  
  82.             _S_c_r_e_e_n _S_o_u_r_c_e _N_o_d_e
  83.  
  84.                +o The valid ports for the screen source nodes are:
  85.  
  86.                   VL_IMPACT_PORT_PIXEL_SRC_A - Single-link 8-bit
  87.                  pixel source from graphics
  88.                   VL_IMPACT_PORT_ALPHA_SRC_A - Single-link 8-bit
  89.                  alpha source from graphics
  90.  
  91.                  The screen source nodes do not have
  92.                  VL_IMPACT_PORT_PIXEL_SRC_B or
  93.                  VL_IMPACT_PORT_ALPHA_SRC_B ports.
  94.  
  95.             _V_i_d_e_o _D_r_a_i_n _N_o_d_e
  96.  
  97.                +o VL_MGV_OUTPUT_HPHASE, VL_MGV_OUTPUT_ALPHA_HPHASE.
  98.                  These controls have range -3071 to 1023 pixels. A
  99.                  value of 0, the default, indicates that the output
  100.                  is aligned to reference.
  101.  
  102.                +o VL_MGV_INPUT_ALPHA_LUT_SELECT,
  103.                  VL_MGV_OUTPUT_ALPHA_LUT_SELECT. These controls
  104.                  reside on the blender node. The input lut is
  105.                  enabled only when a source from outside the CC1 is
  106.                  routed to a blender alpha input. Likewise, the
  107.                  output lut is enabled only when the blender alpha
  108.                  output is sent outside the CC1.
  109.  
  110.             _B_l_e_n_d_e_r _N_o_d_e
  111.  
  112.                +o VL_MGV_BLANK_ALPHA_CHROMA. This control resides on
  113.                  the blender node and allows the chromanince
  114.                  components to be blanked on the alpha output.
  115.                  Valid values for this control are:
  116.  
  117.                   TRUE   Blank chroma
  118.                   FALSE  Pass chroma
  119.  
  120.                  Default: FALSE (pass chroma)
  121.  
  122.                  Type: boolVal
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.                +o VL_MGV_BLEND_A_ALPHA_SELECT. This control allows
  141.                  the blender foreground alpha input to be selected
  142.                  from the external source (VL_BLEND_A_ALPHA), or
  143.                  one of the internal sources (key generator or
  144.                  0.0). Valid values for this control are:
  145.  
  146.                   0      External Blender Input
  147.                   1      Key Generator
  148.                   2      0.0
  149.  
  150.                  Default:  0 (External Blender Input)
  151.  
  152.                  Type: intVal
  153.  
  154.                +o VL_MGV_BLEND_B_SELECT. This control allows the
  155.                  blender background pixel to be selected from the
  156.                  external source (VL_BLEND_B), or one of the
  157.                  internal sources (flat background generator).
  158.                  Valid values for this control are:
  159.  
  160.                   0      External Blender Input
  161.                   1      Flat Background (Constant YUV) Generator
  162.  
  163.                  Default:  0 (External Blender Input)
  164.  
  165.                  Type: intVal
  166.  
  167.                +o VL_MGV_BLEND_B_ALPHA_SELECT. This control allows
  168.                  the blender background alpha to be selected from
  169.                  the external source (VL_BLEND_B), or one of the
  170.                  internal sources (0.0, 1.0). Valid values for this
  171.                  control are:
  172.  
  173.                   0      External Blender Input
  174.                   1      0.0
  175.                   2      1.0
  176.  
  177.                  Default:  0 (External Blender Input)
  178.  
  179.                  Type: intVal
  180.  
  181.        4.2  _F_r_a_m_e_-_A_c_c_u_r_a_t_e__C_o_n_t_r_o_l__S_e_t_t_i_n_g
  182.  
  183.        Prior to Release 6.5, an application setting a control on a
  184.        video stream had no guarantees about which frame/field of
  185.        video the control would first take effect on.  Starting in
  186.        Release 6.5, OCTANE Digital Video and IMPACT Video provide
  187.        the ability to specify the frame/field of video at which
  188.        some controls take effect.  _v_l_S_e_t_C_o_n_t_r_o_l_I_n_L_i_n_e(_3_d_m) and
  189.        _v_l_S_e_t_C_o_n_t_r_o_l_T_r_i_g_g_e_r(_3_d_m) provide interfaces to exercise this
  190.        capability.  Refer to the man pages for further information
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        on the use of these interfaces.
  207.  
  208.        The following limitations apply to frame-accurate control
  209.        changes on OCTANE Digital Video and IMPACT Video.
  210.  
  211.           +o Triggered controls are supported using MSC and GPI
  212.             only.
  213.  
  214.           +o To set a control at a designated time, IRIX realtime
  215.             performance guarantees are relied upon.  To maintain
  216.             these guarantees, applications should not be run at
  217.             realtime priorities higher than priority 155. In
  218.             addition, adequate memory must be present on the system
  219.             to prevent significant levels of paging, as this can
  220.             also interfere with realtime response. (If a control is
  221.             executed later than the designated time due to the
  222.             above-mentioned causes, or because it was submitted
  223.             late, a VLAdvanceMissed event is sent to the
  224.             application).
  225.  
  226.           +o Only the following controls can be set with frame-
  227.             accuracy:
  228.  
  229.             VL_MGV_WIPE_TYPE
  230.             VL_MGV_WIPE_DIRECTION
  231.             VL_MGV_WIPE_SHARPNESS
  232.             VL_MGV_WIPE_ANGLE
  233.             VL_MGV_WIPE_POSN
  234.             VL_MGV_WIPE_POSN_PERP
  235.             VL_MGV_WIPE_CENT
  236.             VL_MGV_WIPE_CENT_PERP
  237.             VL_MGV_WIPE_REPT
  238.             VL_MGV_WIPE_REPT_PERP
  239.             VL_MGV_WIPE_FUZZ
  240.             VL_MGV_CC1_BLANK_WIDTH_CH1
  241.             VL_MGV_CC1_BLANK_WIDTH_CH2
  242.             VL_MGV_CC1_INPUT_ROUNDING_CH1
  243.             VL_MGV_CC1_INPUT_ROUNDING_CH2
  244.             VL_MGV_OUTPUT_FSYNC
  245.             VL_MGV_OUTPUT_DL_SELECT_FREEZE
  246.             VL_MGV_OUTPUT_DL_SELECT_FSYNC
  247.             VL_MGV_KEYER_SOURCE
  248.             VL_MGV_KEYER_MODE
  249.             VL_MGV_KEYER_VALUE_LUMA
  250.             VL_MGV_KEYER_RANGE_LUMA
  251.             VL_MGV_KEYER_FG_OPACITY
  252.             VL_MGV_KEYER_VALUE_CHROMA_U
  253.             VL_MGV_KEYER_RANGE_CHROMA_U
  254.             VL_MGV_KEYER_VALUE_CHROMA_V
  255.             VL_MGV_KEYER_RANGE_CHROMA_V
  256.             VL_MGV_KEYER_DETAIL
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             VL_MGV_BLEND_B_Y
  273.             VL_MGV_BLEND_B_U
  274.             VL_MGV_BLEND_B_V
  275.             VL_MGV_BLEND_H_FILT
  276.             VL_MGV_BLEND_SHADOW_ON
  277.             VL_MGV_BLEND_SHADOW_GAIN
  278.             VL_MGV_BLEND_SHADOW_OFFSET
  279.             VL_MGV_OUTPUT_ALPHA_CHROMA
  280.             VL_MGV_BLENDER_XYMIX
  281.             VL_MGV_BLENDER_THRESH
  282.             VL_MGV_BLENDER_VRAND
  283.             VL_MGV_BLENDER_HRAND
  284.             VL_MGV_BLENDER_SLICE_SEL
  285.             VL_MGV_BLENDER_SEL_MODE
  286.             VL_MGV_CSC_COEF
  287.             VL_MGV_CSC_LUT_IN_PAGE
  288.             VL_MGV_CSC_LUT_ALPHA_PAGE
  289.             VL_FREEZE
  290.             VL_BLEND_A_FCN
  291.             VL_BLEND_B_FCN
  292.             VL_BLEND_A_NORMALIZE
  293.             VL_BLEND_B_NORMALIZE
  294.             VL_BLEND_OUT_NORMALIZE
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.